
<!DOCTYPE html>
<!--

    Copyright (c) 2017, 2019 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->
<html lang="en">
  <head>
    <meta charset="utf-8"/>
    <title>restart-domain</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="css/style.css" rel="stylesheet">
    <script src="https://use.fontawesome.com/96c4d89611.js"></script>
  </head>
  <body>
<table id="doc-title" cellspacing="0" cellpadding="0">
  <tr>
  <td align="left" valign="top">
  <b>restart-domain</b><br />
  </td>
  </tr>
</table>
<hr />

<table width="90%" id="top-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>
		<td align="left">
		<a href="remove-library.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="restart-instance.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>


<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p><a id="restart-domain-1"></a><a id="GSRFM00218"></a><a id="restart-domain"></a></p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_restart_domain">restart-domain</h2>
<div class="sectionbody">
<div class="paragraph">
<p>restarts the DAS of the specified domain</p>
</div>
<div id="sthref1978" class="paragraph">
<p>Synopsis</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin [asadmin-options] restart-domain [--help]
[--debug ={true|false}]
[--domaindir domaindir]
[--force={true|false}] [--kill={false|true}]
[domain-name]</code></pre>
</div>
</div>
<div id="sthref1979" class="paragraph">
<p>Description</p>
</div>
<div class="paragraph">
<p>The <code>restart-domain</code> subcommand stops and then restarts the domain
administration server (DAS) of the specified domain. If a domain is not
specified, the default domain is assumed. If the domains directory
contains two or more domains, the domain-name operand must be specified.
If the DAS is not already running, the subcommand attempts to start it.</p>
</div>
<div class="paragraph">
<p>The <code>restart-domain</code> subcommand does not exit until the subcommand has
verified that the domain has been stopped and restarted.</p>
</div>
<div class="paragraph">
<p>This subcommand is supported in local or remote mode. If you specify a
host name, the subcommand assumes you are operating in remote mode,
which means you must correctly authenticate to the remote server. In
local mode, you normally do not need to authenticate to the server as
long as you are running the subcommand as the same user who started the
server.</p>
</div>
<div id="sthref1980" class="paragraph">
<p>Options</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">asadmin-options</dt>
<dd>
<p>Options for the <code>asadmin</code> utility. For information about these
options, see the <a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a> help page.</p>
</dd>
<dt class="hdlist1"><code>--help</code></dt>
<dt class="hdlist1"><code>-?</code></dt>
<dd>
<p>Displays the help text for the subcommand.</p>
</dd>
<dt class="hdlist1"><code>--debug</code></dt>
<dd>
<p>Specifies whether the domain is restarted with
Java Platform Debugger Architecture (JPDA) debugging enabled.<br>
Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The domain is restarted with JPDA debugging enabled and the port
number for JPDA debugging is displayed.</p>
</dd>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>  The domain is restarted with JPDA debugging disabled (default).<br>
The default is the current setting of this option for the domain that
is being restarted.</p>
</dd>
</dl>
</div>
</dd>
<dt class="hdlist1"><code>--domaindir</code></dt>
<dd>
<p>The domain root directory, which contains the directory of the domain
that is to be restarted. If specified, the path must be accessible in
the file system. The default location of the domain root directory is
as-install`/domains`.</p>
</dd>
<dt class="hdlist1"><code>--force</code></dt>
<dd>
<p>Specifies whether the domain is forcibly stopped immediately before it
is restarted.<br>
Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The domain is forcibly stopped immediately (default).</p>
</dd>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>The subcommand waits until all threads that are associated with the
domain are exited before stopping the domain.</p>
</dd>
</dl>
</div>
</dd>
<dt class="hdlist1"><code>--kill</code></dt>
<dd>
<p>Specifies whether the domain is killed before it is restarted by using
functionality of the operating system to terminate the domain process.<br>
Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>The domain is not killed. The subcommand uses functionality of the
Java platform to terminate the domain process (default).</p>
</dd>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The domain is killed. The subcommand uses functionality of the
operating system to terminate the domain process.</p>
</dd>
</dl>
</div>
</dd>
</dl>
</div>
<div id="sthref1981" class="paragraph">
<p>Operands</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">domain-name</dt>
<dd>
<p>The name of the domain you want to restart. Default is the name
specified during installation, usually <code>domain1</code>.</p>
</dd>
</dl>
</div>
<div id="sthref1982" class="paragraph">
<p>Examples</p>
</div>
<div class="paragraph">
<p><a id="GSRFM738"></a><a id="sthref1983"></a></p>
</div>
<div class="paragraph">
<p>Example 1   Restarting a Domain</p>
</div>
<div class="paragraph">
<p>This example restarts <code>mydomain4</code> in the default domains directory.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; restart-domain mydomain4
Successfully restarted the domain
Command restart-domain executed successfully.</code></pre>
</div>
</div>
<div id="sthref1984" class="paragraph">
<p>Exit Status</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">0</dt>
<dd>
<p>subcommand executed successfully</p>
</dd>
<dt class="hdlist1">1</dt>
<dd>
<p>error in executing the subcommand</p>
</dd>
</dl>
</div>
<div id="sthref1985" class="paragraph">
<p>See Also</p>
</div>
<div class="paragraph">
<p><a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a></p>
</div>
<div class="paragraph">
<p><a href="delete-domain.html#delete-domain-1"><code>delete-domain</code>(1)</a>,
<a href="list-domains.html#list-domains-1"><code>list-domains</code>(1)</a>,
<a href="start-domain.html#start-domain-1"><code>start-domain</code>(1)</a>,
<a href="stop-domain.html#stop-domain-1"><code>stop-domain</code>(1)</a></p>
</div>
</div>
</div>

<hr />

<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>		
		<td align="left">
		<a href="remove-library.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="restart-instance.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>

<span id="copyright">
        <img src="/resource/reference/img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/>&nbsp;            
        <span >Copyright&nbsp;&copy;&nbsp;2019,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span>
</span>

</body>
</html>
